/*
 * Created on 2006-12-1
 *
 * TODO To change the template for this generated file go to
 * Window - Preferences - Java - Code Style - Code Templates
 */
package com.powerunion.datacollection.report.excelreport.datasource;

import java.util.List;
import java.util.Map;

/**
 * Description: 数据库类型数据源查询监听器。该监听器主要用来当使用数据库类型数据源
 * 来检索数据时，客户端程序可以拦截一些诸如取得sql语句等只有数据库类型数据源才具有的事件。
 * @author juny
 */
public interface IDBDataSourceQueryListener {
    /**
     * 取得数据库类型数据源查询sql事件，该函数在数据源准备取得sql语句时调用。
     * 用户可以通过重载该接口，来自己组合数据源查询数据的sql语句。
     * @param dsParamaterNameList 数据源对应的输入参数名称列表
     * @param dsParamaterValues 数据源参数值
     * @return 返回非空字符串：生成好的SQL。返回“”或null则系统调用默认的sql查询（该sql在配置文件中配置）
     */
    String getSql(List dsParamaterNameList, Map dsParamaterValues);
}
